#######################################################################
#							              # 
#                   News Publisher Archives Readme                    #
#		   	   Version 1.02                               #
# 	                                                              #
#                    Created by Grant Williams                        # 
#					                              #
# Created on:  1/23/98          Last Modified on:  3/21/99            #
# I can be reached at:          gcw07@ionet.net                       #
# Scripts Found at:             http://www.roosh.com/news_publisher/  #
#######################################################################
# Please use the forum at the site for support questions and not      #
# email them. The forum is checked often.	                      #
#######################################################################
# COPYRIGHT NOTICE:						      #
# 								      #
# Copyright 1999 Grant Williams    All Rights Reserved.               #
#								      #
# This program may be used and modified free of charge by anyone, as  #
# long as this copyright notice and the header above remain intact.   #  
# By using this program you agree to indemnify Grant Williams from    #
# any liability that might arise from it's use.                       #
#								      #
# Selling the code for this program without prior written consent is  #
# expressly forbidden. Obtain permission before redistributing this   #
# software over the Internet or in any other medium.  In all cases    #
# copyright and header must remain intact.                            #
#                                                                     #
#######################################################################

____________________________________________________________________________


You will also need to edit the archives.cgi file to install to this script.
Below is a description of how to modify the necessary file. This script
is an add-on and is not required to run the news.cgi script.

_________________________________________________________________________

                      CONFIG.CGI ARCHIVES CONFIGURATION
		     ==================================

This file must be placed in your server's cgi-bin, or if your server has 
.cgi extensions allowed, you can simply rename this file to config.cgi. This
file must be chmoded 755. Ask your system administrator for more information 
on either the cgi-bin or chmod command.

This file will be pretty easy to modify, if you already modified the 
config.cgi file for the news script. Below is a summary of how to configure 
all of the variables:

###########################################################################
# Define Variables


$ArchiveScriptUrl = "http://your.host.xxx/cgi-bin/archives.cgi";
	This is the URL that points to archives.cgi. This will be used often
	in the archives.cgi file, so this must be correct. If you renamed 
	archives.cgi to archives.pl, be sure to change the $ArchiveScriptUrl 
	to reflect this change.

$beforedate = "<b>";
	This is the HTML you want before the date is displayed inside the
	archives script.

$afterdate = "</b><p>";
	This is the HTML you want after the date is displayed inside the
	archives script.

$archivesname = "News Archives<p>";
	This is the archives name. It will be displayed on the main page of
	the archives script.

$archivetype = 2;  # 1 - monthly, 2 - weekly
	This is the type of archive you want. If you choose weekly, it is
	every 7 days worth of news placed on a page

   ############ CONTINUE IN THE OTHER CONFIGURATION PART ############

$pageheader = "/path/to/datadirectory/pageheader.txt";
	This is the HTML that you want before the archives results. So you
	can place any HTML in this file. All of it will show up above the
	archives results.

$pagefooter = "/path/to/datadirectory/pagefooter.txt";
	This is the HTML that you want after the archives results. So you
	can place any HTML in this file. All of it will show up below the
	archives results.

##########################################################################


The CGI is now ready to upload. Now onto the second part of configuration.
You must also configure the archives.cgi script, but it is very easy.

First make sure the perl location at the top is correct. Then scroll down to
this line:

require "config.cgi";
require "np-lib.cgi";

If you did not rename config.cgi or np-lib.cgi to anything else you do 
not have to change anything. If you did rename it change the name so that 
it points to the config.cgi and np-lib.cgi files. This file must be placed 
in your server's cgi-bin, like the config.cgi script was. This file must be 
chmoded 755. Ask your system administrator for more information on either the 
cgi-bin or chmod command.

############################################################################
Your done with this. Upload the archives.cgi script and run it. It should be
working. Enjoy.

To use the multiple categories. Make the links to the archives.cgi like this:

<a href="http://www.roosh.com/cgi-bin/archives.cgi?category=1">Category 1 Archive</a>

If you don't add the '?category=1' to the end, it will default to 1. 

To use the all category archive you must enable the "special" all category in the
configuration. Then to view the all categories archives, use use a URL like this:

<a href="http://www.roosh.com/cgi-bin/archives.cgi?category=all">All Category Archive</a>
__________________________________________________________________________________

That should be everything. Enjoy the script.